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CHAPTER I 


GENERAL INFORMATION 


1.1 INTRODUCTION 

The M680Q Co-Resident Assembler is a program that processes 
source program statements written in M6800 Assembly Language, translates 
these source statements into object programs compatible with the M68G0 
Firmware loaders 5 and produces a formatted listing of the source program. 
The M6800 Co-Resident Assembler is compatible with the MPCASM and M68SAM 
cross-assemblers. This Assembler can co-reside in memory with the M680G 
Co-Resident Editor. The editor is described in the H6800 Co-Resident 
Editor Manual . 

1.2 M6S00 CO-RESIDENT ASSEMBLER LANGUAGE 

The symbolic language used to code source programs to be processed 
by the assembler is called the M6800 Co-Resident Assembler Language. 

The language is a collection of mnemonic symbols representing: 

Operations 

- M6SQ0 machine-instruction operation codes 
“ M6800 Co-Resident Assembler directives 
. Symbolic names (labels) 

Operators 
, Special symbols 

1.2.1 Machine Operation Codes 

The assembly language provides mnemonic machine-instruction 
operation codes for all machine instructions in the M6800 instruction 
set. The M680G instructions are described in detail in the M6800 
Programming Reference Manual . Refer to Appendix B for a summary of the 
M6800 instructions . 

1.2.2 Directives 

The assembly language also includes mnemonic directives which 
specify auxiliary actions to be performed by the assembler. Directives 
are not always translated into machine language. (Directives are described 
in Chapter 3 and a summary of directives is included in Appendix C,) 
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1.3 


M68Q0 CO-RESIDENT ASSEMBLER 


The M6800 Co-Resident Assembler translates source statements 
written in M6800 Assembly Language into machine language, assigns 
storage locations to instructions and data, and performs auxiliary 
assembler actions designated by the programmer. 


1.3.1 Assembler Aims 


The two basic aims of the M6800 Co-Resident Assembler are: 


1.3.2 


To translate source programs into object code in the 
format required by the M68O0 resident loaders or an 
EXORciser-compatible loader. 

To provide a printed listing containing the source 
language input, assembler object code, and additional 
information (such as error codes, if any) useful in 
program analysis. 

Assembler Operation 


The assembler reads the source program twice: first, to 

develop the symbol table; second, to assemble the object program 
with reference to the symbol table developed in Pass 1. During Pass 
2, the object code and the assembly listing are generated. Each 
source language line is processed before the next line is read. 


As each line is processed, the assembler examines the location, 
operation, and operand fields. The operation code table is scanned for 
a match with the operation field. If a standard machine operation code 
is being processed, the proper data is inserted into the object code. 

If a directive is specified, the proper action is taken. The object 
code and the assembly listing are formed for output, with any detected 
actual or potential errors flagged before the line containing the error 
is printed, 

1.4 ORDERING INFORMATION 


The M6800 Co-Resident Assembler may be used with the M68G0 
EXORciser, Evaluation Module I, Evaluation Module II and Evaluation Kit. 
Table 1-1 identifies the options of the Assembler, their part numbers, 
and the hardware they are designed to work with. 

1.5 OPERATING ENVIRONMENTS 

1.5.1 Equipment Requirements 

Minimum equipment requirements for the M6800 Co-Resident Assembler 

include : 
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EXORciser, Evaluation Module I, Evaluation Module II, 
or Evaluation Kit 


. 8k bytes of RAM 

. Terminal with TTY (20m A neutral loop current) or RS-232C 
interface and equipped with an automatic reader/punch 
control . 

1.5.2 Software Requirements 

The M6800 Co-Resident Assembler operates with the EXbug 
Firmware, the MIKBUG Firmware, and the MINIBUG Firmware. This Assembler 
also may be used with EXORdisk and the EDOSII software operating system. 

NOTE: 

When using the Co-Resident software with Evaluation Module I 
or the Evaluation Kit modify this hardware in accordance with 
Appendix G. 


TABLE 1-1. Co-Resident Assembler Packages 


HARDWARE 

SOFTWARE 
PACKAGE NAME 

SOFTWARE PACKAGE 
PART NUMBER* 

1 . 

EXORciser 

(EXbug) 

Co- Resident Assembler 

M68ASMR0I3 A, B, D 

2. 

Evaluation 
Module I 
(MIKBUG) 

Co-Resident 
Assembler /Editor 

M68ASM6813 A, B 

3. 

Evaluation 
Module II 
(MIN I BUG II) 

Co-Resident Assembler 

M68ASMR213 A, B 


*A = Cassette, B = Paper Tape, D = Diskette 
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CHAPTER 2 


CODING M6800 CO-RESIDENT ASSEMBLER 
LANGUAGE PROGRAMS 


2*1 SOURCE STATEMENT FORMAT 

Programs written in assembly language consist of a sequence of 
source statements. Each source statement consists of a sequence of 
ASCII characters ending with a carriage return. Refer to Appendix A 
for a listing of the supported ASCII character set. 

Each source statement may include up to five fields: 

. Sequence number 

, Label (or M * M implying a comment) 

, Operation 

. Operand 

* Comment 

2-1.1 Sequence Numbers 

The sequence number field is an option provided as a programmer 
convenience. The sequence number field starts at the beginning of a 
source line and consists of up to five decimal digits (the value must be 
less than 65,536). Sequence numbers must be followed by a space. 

Although sequence numbers are optional * they must be consistently 
used or not used for an entire program. If the first source statement 
includes a sequence number, then every succeeding statement must also 
include a sequence number. If the first source statement is unnumbered, 
then no other statement may be numbered. In this case the Assembler will 
provide sequential line numbers on the assembly listing. 

2.1.2 Label Field 

The label field occurs directly after the sequence number field 
(if there is one) or as the first field of a source line. The label 
field may take one of the following forms: 

(1) An asterisk (*) as the first character indicates that 
the rest of the source line is a comment and should be 
ignored (except for listing purposes) by the assembler, 

(2) A blank (b) as the first character indicates that the 
label field is empty (die line is not a comment and does 
not have a label) . 
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(3) A symbol. 

The attributes of a symbol are: 

. consists of 1 to 6 characters 

, valid characters in a symbol are A through Z 
and 0 through 9, 

, the first character of a symbol must be 
alphabet ic. 

. the symbols "A", "B", and M X" are special symbols 
used by the assembler and should never be used in 
the label field. 

A symbol may occur only once in the label field. If a symbol does 
occur in more than one label field, then each reference to that symbol will 
cause an error. 

A label (symbol in the label field) is normally assigned the 
value of the program location counter of the first byte of the instruction 
or data being assembled. 

The label of an EQU directive is assigned the value of the 
expression in the operand field. 

Some directives must not have a label in the label field. These 
directives include: GRG, NAM, END, OPT, PAGE, and SPC, 

Each symbol in a program is allocated an eight byte block in the 
symbol table. 

2.1.3 Operation Field 

The operation field occurs directly after the label field in an 
assembly language source statement. This field consists of an operation 
code of three or four characters. The rules governing symbols also apply 
to entries in the operation code field. 

Entries in the operation code field may be one of two types: 

, machine mnemonic operation code - these correspond directly 
to M6800 machine instructions. This operation code field 
includes the "A** or * r B" character for the "dual 11 or 
"accumulator* 1 addressing modes. For compatibility with 
other M6800 assemblers, a space may separate the operator 
from the accumulator designation (i.e., LDA A is the same 
as LDAA) . 

. directive - special operation codes known to the assembler 

which control the assembly process rather than being translated 
directly to machine language. 
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The assembler searches for operation codes in the table of 
machine operation codes and directives. If not found, an error message 
is printed. 


2*1,4 Operand Field 


Interpretation of the operand field is dependent on the 
operation field* For the M6S00 machine instructions, the operand 
field must specify the addressing mode* The operand field formats and 


the corresponding addressing modes 

Operand Format 
no operand 
expression 

//< expression > - 

< expression >,X - 


are as follows : 

M6800 Machine Instruction 
Addressing Mode 

inherent and accumulator 

direct or extended 

(direct will be used if possible) 

immediate 

indexed 


Addressing modes and expressions are described in the M6800 
Programming Manual, Assembler directives can take on another form* 
These directives are described in Chapter 3* 


2,1,5 Comment Field 


The last field of an M6800 Assembly Language source line is the 
comment field. This field is optional and is ignored by the assembler 
except for being included in the listing. The comment field is separated 
from the operand field (or the operator field if there is no operand) by 
one or more blanks and may consist of any ASCII character. This field 
is important in documenting the operation of a program, 

2,2 EXPRESSIONS 


An expression is a combination of symbols and/or numbers separated 
by one of the arithmetic operators ( +, or / )■ 

The assembler evaluates expressions algebraically from left to 
right without parenthetical grouping. There is no precedence hierarchy 
among the arithmetic operators, A fractional result, or intermediate 
result obtained during the evaluation of an expression, will be truncated 
to an integer value. 
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2 . 2.1 


Constants 


Decimal: 


< number 




Hexidecimal: 

$ < number > 

or 

< number> 

H 



(first digit 

in 

latter case 

must be 0 - 9) 

Octal: 


< number > 

or 

< number> 

0 or K, number > Q 

Binary: 

% 

^number ]> 

or 

<( number> 

B 


2.2.2 ASCII Literals 

T character > (apostrophe followed by an ASCII character) 

The result is the numeric value for the ASCII character, 

2.3 SYMBOLS 

A symbol in an expression is similar to a symbol in the label 
field except that the value of the symbol is referenced instead of defined. 
An asterisk is a special symbol recognized by the assembler and 

represents the value of the current location counter (first byte of an 
instruction, when used in the context of the symbol, 

A 16-bit integer value is associated with each symbol. This 
value is used in place of the symbol during expression evaluation. 

The M6800 Co-Resident Assembler is a two-pass assembler. The 
symbol table is built on the first pass. Object records and listing are 
produced on the second pass. Certain expressions cannot be fully evaluated 
during the first pass because they may contain (forward) references to 
symbols which have not yet been defined. In some cases, a symbol may 
not be defined before being used in the second pass. Since the assembler 
cannot evaluate such symbols, these cases are treated as errors. Only one 
level of forward referencing is allowed. 

2.4 M6800 ADDRESSING MODES 

2.4.1 Inherent and Accumulator Addressing Mode 

The M6800 includes some instructions which require only an 
operation code byte. These self-contained instructions employ inherent 
or accumulator addressing and do not require the operand field when 
written in the M6800 assembly language, 

2.4.2 Immediate Addressing Mode 

Inmediate addressing refers to the use of one or two bytes 
immediately following the instruction operation code as the instruction 
operand. Immediate addressing is selected by preceding the operand field 
in the source line with the character n # 1! . The expression following the 
'V/ 11 may require one or two bytes, depending on the instruction. 
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2.4.3 


Relative Addressing Mode 


Relative addressing is used by the branch instructions. 

Branches can be made only within the range -126 to 129 relative to 
the first byte of the branch instruction: 

(PC+2)-128 ^ D 6 (PC+2)-KL27 

PC = address of first byte of branch instruction 
D = address of the destination of the branch 

The actual branch offset put into the second byte of the branch 
instruction is the two's complement representation of the difference 
between the location of the byte immediately following the branch 
instruction and the location of the destination, 

2,4.4 Indexed Addressing Mode 

Indexed addresses are relative to the M6800 index register. 

The address is calculated at the time of instruction execution by adding 
the one-byte displacement in the second instruction byte to the current 
contents of the 16-bit index register. Since no sign extension is 
performed, the offset cannot be negative. 

Indexed addressing is normally indicated by the characters ’^X 1 ' 
following the expression in the operand field* (Special cases of ,! ,X Tf or 
ri X M alone are the same as rr G,X rr .) 

2+4.5 Direct and Extended Addressing Mode 

Direct and extended addressing utilize one (direct) or two 
(extended) bytes to form the address of the operand desired. Direct 
addressing is limited to the first 256 bytes of memory, 0-255* Direct 
and extended addressing are selected by simply putting an expression in 
the operand field of the source line. Direct addressing is used if 
possible. An error results if a directly-addressable variable is 
referenced before it is defined in a source program since this can 
cause a phasing error. To avoid phasing problems, directly addressable 
variables should always be defined before any reference to the variable* 

2*5 ASSEMBLER LISTING 

Assembler outputs include an assembly listing and an object 

program. 


2.5.1 Assembly Listing 

The assembly listing includes the source program as well as 
additional information generated by the assembler. Most lines in the 
listing correspond directly to a source statement. Lines which do 
not correspond directly to a source line include; 
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. page header lines 

, error lines (see Appendix D for a listing of error 
numbers) 

. expansion lines for the FCC, FDB, FCB directives 

Most listing lines follow the standard format shown in Table 2-1. 

TABLE 2-1. Standard Format 


(Special cases may not use exactly the same format.) 


COLUMN 

CONTENTS 

1-5 

Source line # - 5 digit decimal counter kept 
by assembler 

7-10 

Current Location Counter value (in hex) 

12-13 

Machine Operation Code (hex) 

15-16 

First byte of operand (hex) 

17-18 

Second byte of operand (if there is one) 

20-25 

Label Field 

27-31 

Operation Field 

34-41 

Operand Field (longer operand extends into 
comment field) 

43-Last 

Comment Field 

Column 



2,5.2 Object Program 

Detailed descriptions of the absolute and relocatable object 
format is included in Appendix E. 
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CHAPTER 3 


ASSEMBLER DIRECTIVES 


3.1 INTRODUCTION 

Assembler directives are instructions to the assembler rather 
than instructions to be directly translated into object code. This 
section describes the directives recognized by the M6800 Co-Resident 
Assembler, 

In Table 3-1 the directives are grouped by function performed. 
Detailed descriptions of each directive are arranged alphabetically. 
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TABLE 3-1. Assembly Directives 


DIRECTIVE 

FUNCTION 

ASSEMBLY CONTROL 


NAM 

Program name 

ORG 

Origin 

END 

LISTING CONTROL 

Program end 

PAGE 

Top of page 

SPC 

Skip M n ,T lines 

OPT NOO 

No object tape 

OPT 0 

(Object Tape) 

The Assembler will generate 
an object tape (selected by 
default) , 

OPT M 

(Memory File) 

The Assembler will write 
machine code to memory. 

OPT NOM 

No memory (selected by 
default) . 

OPT S 

(Print Symbols) 

The Assembler will print the 
symbols at the end of Pass 2, 

OPT NOS 

No printing of symbols (selected 
by default). 

OPT NOL 
(No Listing) 

The Assembler will not print 
a listing of the assembler data. 

OPT L 

The listing of assembled data 
will be printed (selected by 
default) * 

OPT NOP 
(No Page) 

The Assembler will inhibit 
format paging of the assembly 
listing. 

OPT P 

The listing will be paged 
(selected by default) , 

OPT NOG 
(No Generate) 

Causes only 1 line of data 
to be listed from the assembler 
directions FCC, FCB ? and FDB, 


TABLE 3-1. Assembly Directives (Continued) 


DIRECTIVE 

FUNCTION 

OPT G 

DATA DEFINITION /STORAGE ALLOCATION 

All data generated by the 
FCC, FCB, and FDB directions 
will be printed (selected by 
default) . 

FCC 

Character string data 

FCB 

One byte data 

FDB 

Double byte data 

RMB 

SYMBOL DEFINITION 

Reserve memory bytes 

EQU 

Assign permanent value 
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3.2 


END 


FORMAT: END 

DESCRIPTION: The END directive indicates to the Assembler that 

the source is finished. Subsequent source state- 
ments are ignored. The END directive encountered 
at the end of the first pass through the source 
program causes the Assembler to start the second 
pass. 

3.3 EQU - Equate Symbol Value 

FORMAT: label > EQU <^expression> cowmen ts>J 

DESCRIPTION: The EQU directive assigns the value of the expression 

in the operand field to the symbol in the label field. 
The label and expression follow the rules given in 
a previous section. Note that EQU is one operator 
that assigns a value other than the program location 
counter to the label. The label and operand fields 
are both required and the label cannot be defined 
anywhere else in the program. 

The expression in the operand field of an EQU cannot 
include a symbol that is undefined or not yet defined 
(no forward references are allowed). 
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3.4 


FCB - Form Constant Byte 
FORMAT: [<label>] FCB 

, r 

{ < expr > fl 
< null > 

K. expr > 

t. 

comments y 

DESCRIPTION: The FCB directive may have one or more operands, 

separated by commas. An 8-bit unsigned binary 
number corresponding to the value of each operand 
is stored in a byte of the object program. If 
there is more than one operand, they are stored 
in successive bytes. The operand field may contain 
the actual value (decimal, hexadecimal, octal, or 
binary). Alternatively, the operand may be a 
symbol or an expression which can be assigned a 
numerical value by the Assembler, 

An FCB directive followed by one or more null 
operands separated by commas will store zeros for 
the null operands . 


— 

<expr> , 

> 

ft — 

00 r i 

< expr > 

0 L J , 
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3.5 


FCC - Form Constant Character 


FORMAT: 



f d < ASCII string > 
t/s decimal number > , 

< comments 


4 ) 

< ASCII string>j 


NOTE: 1- "d 11 is any non-numeric character (used 

as a delimiter), 

2, ASCII string may not include a carriage 
return* 


DESCRIPTION: The FCC directive translates strings of characters 

into their 7-bit ASCII codes* Any of the characters 
which correspond to ASCII hexadecimal codes 20 (SP) 
through 5F ( ) can be processed by this directive. 

1. Count, comma, text. Where the count specifies 
how many ASCII characters to generate and the 
text begins following the first comma of the 
operand. Should the count be longer than the 
text, spaces will be inserted to fill the count. 
Maximum count is 255, 

2, Text enclosed between identical delimiters, each 
being any single character, (If the delimiters 
are numbers, the text must not begin with a 
comma . ) 
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3.6 


FDB - Form Double Constant Byte 


FORMAT: <label > FDB 

<expr> 

< null> , f 

< expr > 

< comments^ 


<expr> , 

00 

— — 

< expr > 


0 

L- 


DESCRIPTION: The FDB directive may have one or more operands 

separated by commas. The 16-bit unsigned binary 
number corresponding to the value of each operand 
is stored in two bytes of the object program. If 
there is more than one operand, they are stored 
in successive bytes. The operand field may contain 
the actual value (decimal, hexadecimal, octal, or 
binary) . Alternatively, the operand may be a 
symbol or an expression which can be assigned a 
numerical value by the Assembler. 


An FDB directive followed by one or more null 
operands separated by commas will store zeros for 
the null operands. 


The label is optional. 


0 0 1 0 ;L 


NHI'I FOB 

p M 0 p 



00003 


PR0OERH TO ILLUETRRTE USE OF FO 

00004 

r+f 

BVTL' 0 OR0I Tint r. 7 RLC T I VE 

0000*5 




0000 7 

0 0 0 0 

t\ L;U : I 

FtiR 

y 

00000 

0002' 

0000 LffBEL 

FOB 

, FF', IFF, +FFF, , FFFFF 


0004 

00 1 >F 




L-\0P> . 

ppp F 




0000 

0P FF 




00011 

0HE10 




©ea*: 

F FF F 



00000 

OOOE 

00 0C 

FOB 

LRBEL+10, LRBEL+5, LRBEL 


0010 

0007 




0012 

-0002 



0 



ENu 


TOTRL 

ERF: OF: 

:S oO'bOlO 
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3.7 


NAM - Program Name 


3.8 


FORMAT; NAM < program name> ^ < comments > J 

DESCRIPTION; The NAM directive must be the first statement 

of a M6800 Co-Resident Assembler source program. 
The NAM directive does not allow a label* but it 
does require an operand — a program name (one- 
eight characters) . 

The program name from the NAM directive is printed 
on the header line for each listing page. 


OPT - Output Option 

FORMAT: OPT < option > <C option >J 

DESCRIPTION: The OPT directive is used to give the programmer 

optional control of the format of the Assembler 
output. The options are written in the operand 
field and are separated by commas. The options 
may have the character "N0 M as a prefix which 
reverses their meaning. 


OPTION 


MEANING 


OPT 0 

(object tape) 


The Assembler will 
generate an object tape, 
(selected by default) 


OPT N00 


No object tape 


OPT M 

(memory file) 


The Assembler will write 
machine code into memory. 


OPT NOM 


No memory (selected by 
default) , 


OPT S The Assembler will print 

(printed symbols) the symbols at the end 

of Pass 2. 


OPT NOS 
OPT L 

OPT NOL 
(no listing) 


No printing of symbols 
(selected by default)* 

The listing of assembled 
data will be printed 
(selected by default) * 

The Assembler will not 
print a listing of the 
assembled data. 
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OPT P 

The listing will be paged 
(selected by default) . 

OPT NOP 

The Assembler will inhibit 
format paging of the 
assembly listing. 

OPT G 

All data generated by 
the FCC, FOB, and FDB 
directions will be print- 
ed (selected by default) . 

OPT NOG 
(no generate) 

Causes only one line of 
data to be listed from 
the assembler directions 
FCC, FCB, and FDB. 
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3.9 


ORG - Origin 


FORMAT: ORG < expression 


> L< 


comments 


>] 


DESCRIPTION: The ORG directive changes the program counter to 


the value specified by the expression in its operand 
field. Subsequent statements are assigned memory 
locations starting with the new program counter 
value. If no ORG is specified, the program counter 
is initialized with a value of 0. The ORG directive 
may not include a label. 


0 0 0 0 i 
00 0 4 '*il 
0 0 1" 1 0 0 


;*■ F j p ! H J [_t IJ x | P) - ! j H. IJhE. uF "T HE Qf?* T lj T H 

* DIRECTIVE 


NRM ORG 


0 0 ^ 0 
,Tt 0000 



BILL RHB 
JOHN EQU 


.1 

* 


PC 5TRR7S RT ZERO 


ORG 

RI'IB 

I iF'l/j 

RHB 

END 



PC SET TO HEX 20 


JOHN 

J.0 


PC SET TO VALUE OP JOHN 


T uTRL ERRORS 
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3.10 PAGE - Top of Page 

FORMAT: PAGE 

DESCRIPTION: The PAGE directive causes the Assembler to advance 

the paper to the top of the next page. The PAGE 
directive does not appear on the program listing. 
No label or operand is used, and no machine code 
results. 
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RMB - Reserve Memory Bytes 


FORMAT: 


£^label>J RMB ^expression > ^comments 


DESCRIPTION: The RMB directive causes the location counter to 

be increased by the value of the operand field. 

This reserves a block of memory whose length is 
equal to the value of the operand field. The 
operand field may contain the actual number (decimal, 
hexadecimal, octal or binary) equal to the number 
of bytes to be reserved. Alternatively, the operand 
may be a symbol or an expression which can be 
assigned a numerical value by the Assembler. 


The block of memory which is reserved by the RMB 
directive is unchanged by that directive. 

The expression must not contain symbols which are 
defined later in the program (forward references) . 


0 0 0 0 J 
0 0 M 0 <4 
M IdM M 


NhH FtHB 

:J; PR OB PAH ! " ILLUSTRATE USE QF THE RESERVE 

* MEMORV BVTE DIRECTIVE 


0 0 0 L i ; T 

t ■ » n o i 

0 0 0 

CLfti 

RI-iB 

03 0 n ~ : 

0 0 0 J_ 

1 II n-iy 

CLRB 2 

RHB 

M0000 

000-1.0 

000 

0003 


RHE 

END 


T 0 T hL E A R o h S- D o o 0 1 


■i 


‘♦’-CLAES 


*J BVTE RESERVED FOR CL RBI 
2 BVTES RESERVE!' FOR CLRB 
EXPRESS I OH DETERH I NES S I Z 
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SPC - Space 


FORMAT: SPC 

DESCRIPTION: 


< expression 

The SPC directive provides n vertical spaces for 
formatting the program listing. It does not itself 
appear in the listing. The number of lines to be 
left blank is stated by an operand in Che operand 
field. 

The operand would normally contain the actual 
number (decimal, hexadecimal, octal or binary) equal 
to the number of lines to be left blank. A symbol 
or an expression is also allowed. 

When the SPC directives causes the listing to cross 
page boundries, only those blank lines required to 
get to the top of the next page will be generated. 
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CHAPTER 4 


ASSEMBLER OPERATION 


4.1 GENERAL INFORMATION 

The user may have received the M6800 Co- Resident Assembler on 
cassette, paper tape, or diskette. The loading, initialization and 
operation of the Co-Resident Assembler in paper tape and cassette is 
discussed in Paragraph 4.2 while the loading and operation of the 
Co-Resident Assembler from diskette is discussed in Paragraph 4.3. 

4.2 CO-RESIDENT ASSEMBLER TAPE/CASSETTE 

OPERATING PROCEDURES 

4.2.1 Loading Co-Resident Assembler Prom Tape/Cassette 

The Co-Resident Assembler must be present in the EXORciser or 
Evaluation Module memory prior to the initiation of the assembler 
operation. However, it is not always necessary to load the Assembler 
before each assembly operation. If several programs are assembled in 
succession, or if the programs are tested without modifying the memory 
locations used by the assembler, then the Assembler will remain intact 
in memory and available for subsequent uses without reloading. 

4. 2. 2.1 LOADING TAPE/CASSETTE INTO EXORciser MEMORY. Load the 

Co-Resident Assembler into the EXORciser from tape/ cassette as follows: 

a. Place the Co-Resident Assembler object tape (paper tape or cassette) 
into the System Reader Device, 

b. Enter the EXbug command "LOAD", The EXbug Firmware will respond 
with "SGL/CONT" . 

c. Type "S" after SGL/CONT to load the single file containing the 
Co-Resident Assembler. After the header record from the tape is 
printed, the file is loaded into memory. Upon completion, control is 
returned to EXbug . 

4. 2. 2. 2 LOADING TAPE/CASSETTE INTO EVALUATION MODULE MEMORY. Load 
the Co-Resident Assembler into the Evaluation Module from paper tape/ 
cassette as follows: 

a. Load the Co- Resident Assembler object tape (paper tape or cassette) 
into the System Reader Device. 

b. Enter the character L after the asterisk. This initiates the 
Evaluation Module loading procedure. The Evaluation Module loads 
the Co-Resident Assembler into memory and then prints an asterisk. 
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4.2.2 


Assembler Initiation 


In normal operation, the memory region between the end of the 
Co-Resident Editor and location $2000 is used by the Assembler for 
the symbol table. This table provides space for 90 symbols. If a 
larger symbol table is required, the symbol table area can be extended 
at either end . 

By selecting the editor over-write feature, the area occupied 
by the Co-Resident Editor can be appended to the beginning of the 
symbol table. This increases the symbol table capacity to 312 symbols. 
The over-write option is enabled by using MAID to change the contents 
of memory location 303^ to FF^, 


1,5 r#ID 
♦3Ci3^Cm 


If more than 8k bytes of read-write memory are available, 
additional memory can be appended to the end of the symbol table. 

This is accomplished by modifying the end-of-symbol-table address in 
memory locations 301]^ and 302-^. Eight bytes of read-write memory 
are required for the storage of each symbol. Modifying locations 
301-j^ and 302-^ to contain 2400w extends the symbol table by Ik bytes, 
or 128 symbols for a total of 218, assuming the editor over-write is 
not selected. 


-:-:bu3 i.3 
* 3 r* 1 ' 30 34 
0 3 u y 0 U 0 


If the object code is to be written into memory (OPT M) , the 
end-of-symbol-table address delimits the address. For example, if the 
symbol table ends at 200(3^ {the default value), a program beginning 
at 2QGQ^ t - or higher may have its output directed into EXORciser memory 
(assuming the memory is available). If, on the other hand, only 8k of 
memory Is available and the programmer wishes to assemble into memory 
(OPT M) , the symbol table can be shortened to make memory available 
for the object code. This is accomplished by changing the end-of-symbol- 
table address to a lower address. For example, assume 1F00^ is the 
new end-of-symbol-table address. 


E*:BU 1 3 1.5 MPID 
♦ 3 0 1 -5 0 1 F 

\j 3 fi 3 ■ i j u i'i 0 
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A program beginning at IFOO^ now can be assembled into memory. 

Should an end-of-symbol-table address be entered that is less 
than the start-of-symbol-table address, the Co-Resident Assembler uses the 
default address 2000^. 

A user's program may take advantage of the direct addressing mode 
and use the first 256 bytes (O-lOO^g) for scratch memory. However, no 
instructions that generate data; such as FCC, FDB, or FCB; may be assembled 
into this area because the Assembler and Editor also use this portion of 
memory for scratch storage. 

Figure 4-1 depicts a memory map of the Co-Resident Assembler. 


Memory Map 
Tape Version 
Assembler Operation 


Memory Map 
Disk Version 
Assembler Operation 


HEX 


HEX 


0000 

0100 

0300 

1610 

1D00 

2000 


SCRATCH 


I/O ROUTINES 


RESIDENT 

ASSEMBLER 


RESIDENT 

EDITOR 


SYMBOL TABLE 
(93 SYMBOLS) 


OPTIONAL USE 
AS SYMBOL TABLE 

i 


OPTIONAL USE 
AS SYMBOL TABLE 
225 ADDITIONAL 
SYMBOLS 


0000 

0100 

0300 


1610 


SCRATCH 


I/O ROUTINES 


RESIDENT 

ASSEMBLER 


SYMBOL TABLE 
CONTINUES TO 
THE END OF 
CONTINUOUS RAM 


NOTE: (TAPE VERSION ONLY) 

The editor overwrite flag is at $303. 

If it is zero the editor area will not 
be used as symbol table. If it is non- 
zero the editor area will be used as sym- 
bol table. 

Locations $301~$302 contain the address 
of the end of the symbol table. The de- 
fault value of $2000 may be changed by 
the user. 

FIGURE 4-1. Memory Maps of Co-Resident Assembler. 
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Selection of the Editor over-write feature and modification of 
the end-of-symbol-table must be done after the Assembler has been 
loaded and before it is initiated. Figure 4-2 illustrates the procedure 
for loading the Assembler and initiating it without modification. 
Appendix F depicts the Program Assembling Procedures. 

EXBUG 1.2 L.OAB 
i3_’'CQHT S 
A SMI . 3 

EXBUG 1.2 HA ID 
* i o o ; '5 

’•l-bSOO PCS I DENT ASSEMBLER 1.3 
CG D VR IGHT HQ TORCH. A 1976 
E r i TE P P h y v. : 1 p * 1 y • c’ P * dL « c T 

1 P 

■I-.om ij C'Ei lDENT m i S-EHELER 1.3 
! G Q YP IGH T HOTOROLfi 1976 
ENTER* PA i S • 1 P * 1 5‘ » 2F* f £L f 2 T 


FIGURE 4-2. Program Assembling Procedures 

4.2.3 Tape/Cassette Co-Resident Assembler Operation 

The Co-Resident Assembler is a two-pass assembler. That is, 
the Co-Resident Assembler must read a source program twice — once to 
build a symbol table and a second time to produce the assembled output. 
In response to the assembler prompt message. 

ENTER PASS: IP, IS, 2P, 2L, 2T 

Select the appropriate assembler pass. The Co-Resident Assembler Pass 
controls are described in the following paragraph and are summarized in 
Table 4-1. 


TABLE 4-1. Co-Resident Assembler Pass 
Controls and Options 


CONTROL 

DESCRIPTION 

IP 

Pass 1, clears symbol table 

IS 

Pass 1, inhibits clearing of symbol table 

2P 

Pass 2 y assembly listing and object tape 


output . 

2L 

Pass 2^ assembly listing only 

2T 

Pass 2, object tape only. 
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PASS IP — Pass 1 produces a table of the symbols which appear in the 
program and the corresponding memory addresses to which they are assigned. 
This table is used in Pass 2 to determine the address field for instructions 
which reference memory symbolically. Program syntax is also checked in 
Pass 1, and errors are listed, 

PASS 1 Option IS — In the assembly of multiple source tapes, it may be 
advantageous to be known to each assembly. The S option for Pass 1 
inhibits the clearing of the symbol table before the pass is started* 

PASS 2F — Pass 2 rereads the source tape and uses information in the 
symbol table to produce the assembled output. Using terminals which 
permit independent on/off control of the tape output and printer devices , 
Pass 2 can produce both an object tape and an assembly listing, A 
terminal without independent controls will permit the generation of 
either an object tape or an assembly listing (not both). In this case, 

Pass 2 may be repeated to generate both output forms, 

PASS 2 OPTIONS 

2L — The L option for Pass 2 is used to generate only an assembly 
listing (no object tape), 

2T — The T option for Pass 2 is used to generate an object tape 
(no assembly listing) , 


NOTE: 

One-Pass Operation, For source programs which have no 
symbolic forward references, Pass 1 may be omitted. For 
short programs with only a few forward references, it is 
also possible to omit Pass 1, In this case, however, the 
forward references will be flagged with error 211 and the 
assembled program with an address field of FFFF, The 
correct address can be patched after the symbol table is 
printed at the completion of the assembly. 

In combination with the options for entering a source 
program from the terminal keyboard and for assembling 
an object program in memory, short programs may be 
assembled and executed without the use of tapes, 

4,3 CO-RESIDENT ASSEMBLER DISKETTE OPERATING PROCEDURES 

4,3.1 Disk Co-Resident Assembler Operating Characteristics 

The Co-Resident Assembler on diskette, when working with the 
EXORdisk with its EDOS Firmware, has several unique characteristics. 
In this application, the EDOSII Firmware automatically selects the 
Editor-overwrite option. Also the assembler searches the EXORciser 
for the end of its continuous memory to deter the end-of-symbol-table 
address . 


If the user wishes to use the OPT M directive and insert the 
assembled output into memory he must provide a block of memory that is 
not continuous with the memory being used by the Co- Resident Assembler. 

4.3.2 Diskette Co-Resident Assembler Operation 

The Co-Resident Assembler is a two pass assembler that resides 
in the diskette file named ASMB, That is, in its assembly operation 
the Assembler reads the source program twice — once to build a symbol 
table, and a second time to produce the assembled output. Unlike the 
two pass operation of the assembler on tape or diskette, this assembly 
automatically performs the two passes in sequence. 

This assembler working with the EXORdisk T s EDOS Firmware assembles 
the source file and directs the assembled object output (if selected) 
to the object file and the assembly listing (if selected) to the terminal 
device. In initiating the assembly process, the user instructs the 
EXORciser to run the EDOS Firmware, On receiving the EDOS prompt (!) 
the user enters the appropriate assembly command. The three assembly 
operations are described in Figure 4-3 and illustrated in Figure 4-4. In 
entering the assembly command, all three operands must be specified. In 
the case where no object file is to be created, any dummy file name may 
be entered in the operand field. In this case, no file entry will be 
created on the diskette. 
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Name : 


ASM 


Format: 
Purpose : 

Comments : 


Example: 


ASM, passoption, objectf ilename, sourcef ilename 

To assemble the contents of the source file and to direct 
the assembled object output, if any to the object output 
file and the assembled listing, if any, to the list device, 

All three operands must be specified. If no object file is 
to be created, any dummy file name (i,e* X or Y or Z etc*) 
may be entered in this operand field since no file directory 
entry will be created. 

The pass option operand field may contain the number 2, 3, 
or 4 ■ 

2 ” both an assembly listing and an object output are 

produced , 

3 = only as assembly listing is generated to the list 

device* 

4 = only an object output is generated to the output 

object file, 

ASM,4 , JOEO, JOES 

Produce an object file named JOEG from the source file named 
JOES* 


— FIGURE 4-3* Assemble (ASM) Command 

E'OG !.£ pH I D 

* z.S 0 0 * 3 

•%“300 EDOS VC5. £.£ 

! 3S r, i ’ — * ps'hot ? psm 
1 33 0 0 PE S I DEH T h 5 EM ELEP 1 , 3 

: j py p i gh r mo tdpol* i . 7 6 


FIGURE 4-4* Example of Disk Assembly Operation 
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APPENDIX A 


CHARACTER SET 


The character set recognized by the Motorola >16800 Co-Resident 
Assembler is a subset of ASCII (American Standard Code for Information 
Interchange, 1968)* The ASCII Code is shown in the M6800 Programming 
Reference Manual* The following characters are recognized by the assem- 
bler* 

1* The upper case letters A through Z 
2* The integers 0 through 9 
3* Four arithmetic operators: 

+ - * / 

4* Characters used as special prefixes: 

# (pounds sign) specifies the immediate mode of addressing 

$ (dollar sign) specifies a hexadecimal number 

@ (commercial at) specifies an octal number 
% (percent) specifies a binary number 
1 (apostrophe) specifies an ASCII literal character 
& (ampersand) specifies a decimal number 

5, Characters used as special suffixes: 

B (letter B) specifies a binary number 
H (letter H) specifies a hexadecimal number 
0 (letter 0) specifies an octal number 

Q (letter Q) specifies an octal number 

6* Three separating characters: 

SPACE 

CR (carriage return) 

, (comma) 

7, A comment in a source statement may include any characters 
with ASCII hexadecimal values from 20 (SP) through 5F ( ) . 
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8. In addition to the above, the assembler has the capability 
of reading string of characters and of entering the 
corresponding 7-bit ASCII code into specified locations in 
the memory. This capability is provided by the assembler 
directive FCC (see Chapter 3>. Any characters corresponding 

to ASCII hexadecimal values 20 (SP) through 5F ( ) can be 

processed. This kind of processing can also be done, for a 
single ASCII character, by using the immediate mode of 
addressing with an operand in the form " ' C". 
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APPENDIX B 

SUMMARY OF M6800 INSTRUCTIONS 
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1 ‘B 

* 

4 

l 

l 

T 

i 

> 

OH 

EOftA 

IS 

2 

2 

9B 

l 

2 

AB 

5 

2 

M 

4 

3 




A0M * A 

4 

4 

1 

T 

H 

i 

i 


EOR& 

CB 

2 

2 

08 

1 

2 

EB 

& 

2 

ffi 

4 

3 




a©v - b 

4 

4 

l 


R 

i 

i 

1 naif ruin 

INC 







SC 

f 

2 

/C 

§ 

3 




M 

. J » V 

4 

4 

l 

I 

S; 

i 

* 


INCA 













4C 

7 

1 

A ' 

p I -A 

• 

4 

l 


© 

■ 

* 


INCH 













SC 

7 

1 

B ■ 

‘1 e 

* 

4 



: 

© 

H 

* 

Laid AtfirtM 

ldaa 

IE 

2 

2 

% 

3 

l 

A& 

% 

2 

66 

4 

3 




y 

‘A 

4 

4 




F 

t 


* 


LDAB 

L‘ 

7 

2 

06 

3 

2 

IS 

i 

I 

FG 

4 

3 




w 

-B 

4 

4 




F 

1 

1 

i 

Or. trttlutov* 

DRAA 

BA 

1 

2 

9* 

3 

2 

AA 

b 

? 

6A 

4 

3 




A * M * A 

4 

4 



* 

f 

1 

1 

t 


DRAB 

CA 

1 

? 

DA 

3 

2 

fcA 

b 

2 

FA 

4 

3 




fi - 

‘At -R 

4 

4 



♦ 

* 

R 

4 

i 

FuiA Dili 

PSHA 













IE 

4 

1 

A 

• VjF. SP - 1 -S P 










PSH0 













3J 

4 

1 

1 

- VSP SF - 1 * SF 









Full Djtj 

PULA 













12 

4 

1 

SP 

* t ‘SP. Msf -A 










POLB 













33 

4 

1 

SP 

* 1 -$p. 









Halit* UH 

ROL 







St 

l 

7 

79 

fl 

3 




Ml 

l j 1 

4 

4 

I 

i 

© 

: 

E 


HULA 













49 

2 

| 

A 

> l-a * rr\ir, 

* 

4 

J 

i 

© 

■1 

! 


HGLfi 













99 

l 

1 

it I 

C !>; ' C3 

4 

4 



: 


3 

: 

RbIiI* R./'l 

RQR 







IS 

J 

3 

JG 

v 

3 




M 

1 1 1 

4 

4 



: 

© 

I 


ROHA 













4& 

2 

t 

A 

} --h 3 * r r r i : l — * 

• 

* 



: 





Rons 













M 

i 


ii 

| C bJ ■* DO 

4 

4 



: 

i 

: 


SftiTf L#ll A'lMtiwtu 

ASL 







m 

7 

? 

J* 

6 

J 




M 

* 

4 

4 




<£J 

■ 

; 


ASIA 













43 

2 

t 

A 

f C - .i. ..-o 

4 

4 

I 


© 

1 



ASLB 














2 

1 

vl 

| C bJ bO 1 

4 

4 

t 


i 



Shill n.-ghl. AfitHnvM 

ASft 







6/ 

7 

2 

72 

& 

3 




M 

l n - 

• 

4 

l 


© 




ASflA 













4/ 

l 

1 

A 

\ n : : : f : 1 1 - a 

• 

• 

l 

! 

© 




ASRB 













57 

7 

1 

ft 1 

|b? tiO C 

4 

* 

I 

: 

© 

: 


Shill ftujM. Lflific 

LSR 







$4 

7 

2 

74 

| 

3 




» 

- 

4 

4 

ft 

r 

© 

j 



L SR A 













44 

7 

t 

A 

> Q-aiUTLU - □ 

4 

4 

ft 


© 




LURE 













W 

i 

t 

*] 

b7 00 C 

• 

4 

P 


© 


: 

Stcup Afmltr 

ST A A 




§7 

4 

7 

A i 

& 

2 

67 

b 

3 




A 

‘V 

4 

4 



i 

FT 

i 

» 


stab 




OJ 

4 

7 

H 

- 

I 

47 

S 

J 




ft 

>u 

4 

4 



i 

f 

t 

A 

» 

SubTrjiT 

SUB A 

10 

| 

2 

10 

3 

7 

AD 

b 

2 

10 

; 

j 




A 

M * A 

4 

4 



: 






5UBB 

CO 

2 

I 

DO 

3 

2 

EQ 

b 

2 

to 

4 

3 




1 

- V *R 

4 

4 

l 

; 





Sublet At mint 

SB A 













10 

7 

t 

A 

S -A 

4 

4 

1 

: 





Subli #ih Gill* 

SBCA 

02 

2 

7 

s? 

3 

7 

A? 

b 

2 

B7 

4 

3 




A 

V C - A 

4 

4 

1 

t 






ESCB 

u 

2 

2 

02 

3 

l 

12 

s 

2 

F7 

4 

3 




FI 

V ^ C *B 

* 

4 

1 

i 





Tlii'llrl AmnUfi 

TAB 













IE 

i 

1 

A 

■ n 

4 

4 

3 

t 

f 

l 

* 

» 


TBA 













\t 

2 

1 

g 

‘A 

4 

4 



i 

f 

t 

* 

* 

!>I1 ZttO or UtUut 

TST 







ED 

2 

2 

JO 

£ 

3 




M 

00 

4 

4 



t 

R 

R 


1ST A 













1U 

2 

t 

A 

00 

4 

4 



■ 

Ft 

1 

i 


TSTfi 













HJ 

2 

1 

E 

oo 

* 

* 



i 

* 

l 

R 


n 

1 

H 

i 

V 

C 


LEGEND 



CONDITION CODE SYMBOLS 

OP 

Q'prrttid' 1 Codk 

+ 

OflO'UM 1t1cR4h( Oft 



* 

N jimiMr MPU Ciftfn. 

0 

6aa!t*'i f Pdmir# 00 

H 

Mill t*!Ty Nom till 1 

- 

Nwmbrr ol Piflffim B*rei 

9 

Ca'i’tilr^Fiit o' M 

1 

Interrupt rruil 


Aniri^fTfC pr^t 

- 

tii'uiit tnts. 

H 

Nt^iT'i? 1 HJi’i till! 

- 

AnTb "^Tif 

Q 

8)1 Aid 

l 

Ac ib*T*l 

* 

E']Q ! rir AND 

ca 

a>!> ‘ Zrro 

V 


“SF 

Conrrvit|.ot mimorv igcititip eo>ni«d m r* Si*:* Fs'«fr r 



C 

Cj>r * lr#o bn 2 





R 

RftfJ AUlf L 


Kali - Atcumwljro* mod* K»iQuGt4«i vr i *. tfffl «*t cflMnwi 1*1 IMHUO % S Set AIajvi 

! Ttii jiiiJ 1*1 i* |Tur, [Jrt<td 

* No l Aftrjt#d 


MC6800 INSTRUCTION SET 
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cowd. code reg 


POINTER OPERATIONS 

MNEMONIC 

IM'.lEO 

DIRECT 

INOEX 

EXTND 

IMPLIED 

BOOLEAN/ARITHMETIC OPERATION 

5 

7 

3 

2 

1 

0 

OP 

- 


OP 

- 

= 

OP 

■ 

- 

OP 

- 

- 

OP 

- 

s 

H 

1 

N 

1 

V 

c 

Compare Indies Reg 

CPX 

ac 

3 

3 

9C 

4 

2 

AC 

E 

2 

EC 

5 

3 




xh M.xt-m + H 

• 

• 

© 

: 

I 

4 

Decrement Index Reg 

DEX 













09 

4 

1 

X - 1 'X 


4 

4 

: 

4 

4 

Decrement Stack Pmr 

BES 













34 

4 

l 

SP 1 — SP 







Increment Index Reg 

INX 













OS 

4 

1 

X * 1 * X 

4 

4 

4 

i 

4 

4 

Increment Stack Pmr 

INS 













31 

4 

1 

SP * 1 - SP 







Load Index Reg 

LDX 

CE 

3 

3 

OE 

4 

Z 

EE 

6 

2 

FE 

5 

3 




M -Xh. im *11 -X L 

* 

■ 

® 

i 

R 

4 

Load Stack Pn|r 

LOS 

8E 

3 

3 

9E 

4 

2 

AE 

6 

2 

BE 

& 

3 




— SPh- <w * lMSPi 

4 

4 

® 

■ 

R 

4 

Store Index Reg 

ST X 




DF 

5 

2 

EF 

7 

2 

FF 

6 

3 




X H *M, X L *fM* It 

4 

• 

i 

i 

R 

4 

Store Stack Pnlr 

STS 




9F 

5 ( 

2 

AF 

7 

2 

BF 

G 

3 




sph -m.spl -im * n 

4 

• 

vt 

; 

n 

4 

Inds Reg * Slack Prut ' 

TXS 













3* 

4 

1 

X -1 - SP 







Stack Pntr — Indt Reg 

TSX 













30 , 

Jj 

1 

SP * f - X 

• 







CONQ. CODE REG. 


OPERATIONS 

MNEMONIC 

RELATIVE 

INDEX 

EXTND 

IMPLIED 

BRANCH TEST 

5 

4 

3 

2 

1 

0 

DP 

- 

“ 

OP 

- 

- 

OP 


- 

OP 

1 "" 


H 

1 

H 

1 

V 

c 

Bf inch Always 

BRA 

20 

4 

7 










None 

4 

4 

4 

4 

4 

4 

Branch If Carry Clear 

BCC 

24 

4 

2 










C = 0 

4 

4 

4 

4 

4 

4 

Branch If Carry Set 

BCS 

25 

4 

2 










Q m 1 

4 

4 

4 

4 

4 

4 

Branch (1 - Zero 

BEQ 

27 

4 

2 










Z - 1 

4 

4 

4 

4 


4 

Branch II "Zero 

BGE 

2Q 

4 

2 










fj Q v* o 

4 

4 

4 

4 

4 

4 

Branch II > Zero 

BGT 

2E 

4 

1 










Z • fN0 VI" 0 

4 

4 

4 

4 

4 

4 

Branch II Higher 

m 

22 

4 

2 










o z - a 

4 

4 

4 

* 

4 

4 

Branch If < Zero 

BLE 

2F 

4 

2 










Z* IN © VI- 1 

* 

4 

4 

4 

4 

4 

Branch If Lower Qc Same 

BLS 

23 

4 

7 










C-Z= 1 

4 

• 

4 

* 

4 

4 

Branch If <Zero 

BIT 

20 

4 

2 










N © V = t 

* 

* 

4 

4 

* 

4 

Branch If Minus 

SMI 

2B 

4 

2 










N = 1 

4 

4 

4 

* 

4 

4 

Branch 11 Not Equal Zero 

BNE 

2F 

4 

2 










Z-0 

* 

• 

* 

* 

4 

4 

Branch If Overltovy Clear 

BVC 

2B 

4 

2 










V = 0 

4 

4 

4 

4 

* 

4 

Branch If Oversow Set 

BVS 

29 

4 

2 










V = 1 

4 

4 

4 

4 

4 

4 

Branch If Pins 

BPL 

2A 

4 

2 










N = 0 

* 

4 

4 

9 

4 

9 

Branch To Subroutine 

SSR 

8D 

3 

2 










| 

9 

4 

4 

4 

• 

* 

Jump 

JMP 




BE 

4 

2 

n 

3 

3 




See Special Operations 

4 

4 

4 

4 

4 

4 

Jump To Subroutine 

JSR 




AD 

a 

2 

3D 

9 

3 




1 

4 

4 

4 

4 

S 

4 

No Operation 

NOP 










01 

z 

\ 

Advancer Prog Cuff Only 

* 

9 

4 

* 

4 

4 

Return Frpm Interrupt 

RTt 










3S 

10 

t 


A 


Return From Subroutine 

RTS 










39 

5 

1 

| 

* 

* 

* 4 

4 

4 

Software Interrupt 

SWI 










3F 

12 

t 

/ See Special Operation* 

0 

4 

0 

9 

* 

9 

Wait lor Interrupt * 

iV A l 










3E 

9 

T 

) 

4 

© 


9 



4 

« 


•'.VAl cuts Address, Bus. H AV, and Data Bus in the three siaie mode whif* V M A is held low 


COWD CODE REG 




IMPLIED 

BOOLEAN OPERATION 

5 

4 

3 

2 

T 

0 

OPERATIONS 

MNEMONIC 

OP 

rr 

IT 

H 

1 

H 

2 

V 

C 

Clear C^iry 

CIO 

QC 

2 

1 

a-c 

4 

4 

* 

4 

4 

; R 

Oar Interrupt Maik 

cu 

OE 

2 

1 

O-l 

9 

R 

4 

4 

4 

4 

Dear Overflew' 

CLV 

OA 

2 

1 

0- V 

9 

4 

4 

4 

R 

9 

Set Catty 

SEC 

OD 

2 

1 

I -c 

9 

4 

4 

9 

4 

s 

Set Interrupt Mask 

SEI 

OF 

2 

1 

i -i 

4 

s 

4 

4 

9 

9 

Set Overflow 

SEV 

08 

2 

1 

1 -v 

4 

9 

4 

4 

s 

4 

Acmltr A - CCR 

TAP 

06 

2 

J 

A - CCR 


— 




CCR - Acmltr A 

TPA 

07 

2 

I 

CCR -A 

V 

..*1 




* 


CONDITION CODE REGISTER NOTES iBit set it less is Hup and cleared othprwrse] 


1 

(Bit VI 

Ten Result - lOflOODGO 7 

7 

(Bit N| 

Test: Sign bit at must significant (MSI hyte - P 

2 

(Bit C] 

Ten Result - QQOOOOOO^ 

a 

(Bit VI 

Test 1 2 's complement overflow from subtraction d MS bytes? 

3 

tSil 0 

Test: Decimal value oi most significant BCD Character greater than nine? 

9 

(BitNI 

Test Result less than zero? (Bit 15-1) 



(Not cleared ■! previously set 1 

ID 

(All) 

Load Condition Code Register Imm Stack (See Special Operations) 

4 

tun v) 

Test Operand - 1 QQOOGOO prior to execution 7 

11 

(Bull 

Bel when interrupt occur* II previously set, a Non-Maskable 

5 

(Bit M) 

Teif Operand - 01111111 prior to execution? 



Interrupt, is required tn exit The wait state 

8 

(Bit V) 

Test: Set equal to result of N0C alter shift has occurred. 

12 

(All) 

Set according to The content* of Accumulator A 


MC6800 INSTRUCTION SET (CONTINUED) 
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APPENDIX C 


M6800 Co-Resident Assembly Directives 
Summary 


DIRECTIVE 

FUNCTION 

ASSEMBLY CONTROL 


NAM 

Program name 

ORG 

Origin 

END 

LISTING CONTROL 

Program End 

PAGE 

Top of page 

SPC 

Skip "n" lines 

OPT NOO 

No object tape 

OPT 0 

(Object Tape) 

The Assembler will generate 
object tapes (selected by default) . 

OPT M 

(Memory File) 

The Assembler will write machine 
code to memory. 

OPT NOM 

No memory (selected by default). 

OPT S 

(Print Symbols) 

The Assembler will print the 
symbols at the end of Pass 2. 

OPT NOS 

No printing of symbols (selected 
by default). 

OPT L 

The listing of assembled data 
will be printed (selected by 
default) . 

OPT NOL 
(No Listing) 

The Assembler will not print a 
listing of the assembled data. 


C-l 


M6800 Co-Resident Assembly Directives 
Summary (Con tinned) 


DIRECTIVE 

FUNCTION 

OPT P 

The listing will be paged (selected 
by default) * 

OPT NOP 

The Assembler will inhibit format 
paging of the assembly listing. 

OPT G 

All data generated by the FCC 3 FCB, 
and FDB directions will be printed 
(selected by default)* 

OPT NOG 
(No Generate) 

DATA DEFINITION /STORAGE ALLOCATION 

Causes only 1 line of data to be 
listed from the assembly directions 
FCC, FCB, and FDB* 

FCC 

Character string data (Form constant 
character) 

FCB 

One byte data (Form constant 
byte) 

FDB 

SYMBOL DEFINITION 

Reserve memory bytes (Form double 
byte) 

EQU 

Assign permanent value 
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APPENDIX D 


201 

202 

204 

205 

206 

207 

208 

209 

210 
211 


ASSEMBLER ERROR MESSAGES 


NAM DIRECTIVE ERROR 

MEANING: The NAM directive is not the first source statement, 

or it occurs more than once in the same source 
program (Applies only to version 1.2) 

EQU DIRECTIVE SYNTAX ERROR 

MEANING: The EQU directive requires a label (Applies only to 

version 1.2) 

STATEMENT SYNTACTICALLY INCORRECT 

MEANING: The source statement is syntactically incorrect 

LABEL ERROR 

MEANING: The statement may not have a label or the label is 

syntactically incorrect. 

REDEFINED SYMBOL 

MEANING: The symbol has been previously defined. 

UNDEFINED OPCODE 

MEANING: The symbol in the operation code field is not a valid 

operation code mnemonic or directive. 

BRANCH ERROR 

MEANING: The branch count is beyond the relative byte's range. 

The allowance is 

(* +2) - 128 D (* +2) + 127 

where D = address of the destination of the branch 
instruction. 

* = address of the first byte of the branch 
instruction. 


ILLEGAL ADDRESS MODE 

MEANING: The mode of addressing is not allowed with the 

operation code type. 

BYTE OVERFLOW 

MEANING: A one byte expression has been converted to a value 

greater than 255 -^q or less than -128 ^q. 

UNDEFINED SYMBOL 

MEANING: The symbol does not appear in the label field. 


213* EQU DIRECTIVE SYNTAX ERROR 

MEANING: The EQU directive requires a label. 

216 DIRECTIVE OPERAND ERROR 

MEANING: The directive operand field is in error. 

218 MEMORY ERROR 

MEANING: The memory option was used and the object code was 

directed to overwrite the assembler/ editor onto 
non-existent memory. 

220 REDEFINED LABEL ERROR 

MEANING: The symbol in the label field has been redefined and 

has a different value on Pass 2 than on Pass 1. 

221 SYMBOL TABLE OVERFLOW 

MEANING: The symbol table has overflowed. See assembler 

operation paragraph in Chapter 3 for extending the 
symbol table. 

* In version 1.2 ERROR 213 is a redefined symbol error. 
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APPENDIX E 

ABSOLUTE OBJECT RECORD FORMAT 




Leader (NuNs* 


(Null*} 

(CR} Formatting for printer 

( L F } readabi Ji ty : ignored by teade r 

(Null) 

S - Start of record 
CC : Type of Record 

Byte Count (two frames - 
one byte} 


Address /Size 


Data 


Checksum 


Frames 3 through N are hexadecimal digns (in 7-bit ASCII} which are concerted 
to BCD, Two BCD digits are combined to make one 3-bit byte 

The checksum is the one's complement of the summation of 8-bd bytes. 


Byte Count 


Frame 

1 Start-of-Record^ 
2. Type of Record 

3 

4 

5 

6, Addreis/Size 

7. 

S 

9- , 


10 . 


Data 


N Checksum 


CC - 30 

Header 

Record 


53 

30 

31 
3? 
30 
30 
30 
30 
34 
38 
34 

34 

35 

32 



0000 


48-H 


4AD 


52- R 


39 

45 


9E 


CC - 31 CC s 39 

Data End-of-File 

Record Record 

53 

s 

53 

S 

3T 

i 

39 

9 

31 

36 

16 

30 

33 

03 

31 

31 

30 

30 

1100 

30 

30 

30 

30 

0000 

39 

39 

93 

46 

43 

FC 

30 

32 

41 

(Checksum} 

A8 iChecksum) 

49 


El 


APPENDIX F 


SAMPLE PROGRAM 


PAGE 

0 Ci 1 

PGM 





0 Li Cl 0 1 



rmr-i 


PGM 


0 1] [i 02 



♦ REVISION 

1 



m n ft n 3 



OPT 


□ 

OUTPUT OBJECT TARE 

0 fi 0 0 4 



□PT 


4S 

SELECT PRINTING OF SYMBOLS 

0 ill 0 05 



□ D T 


rl 


0 0 0 06 

d 0 0 0 


□RG 


'Ed 0 0 0 


0 0 0 07 


0 0 0 3 

COUNT EQIJ 


93 

9 INDICATES OCTAL 

0 0008 

£ l j l j 0 

8£ 8 032 

START LDS 


iiST ACK 

I HZ STACK POINTER 

fi n n Oh 

S. i j i j 3 

PE 8036 

LDX 


ADDA 


C' U ij 1 0 

d i j I j 6 

C6 03 

LDA 

E 

"COUNT 

I MMED I ATE ADDRESS I NG 

0 Ij o 1 1 

£ 0 03 

96 OR 

BACK LDfl 

fl 

1 0 

DIRECT ADDRESSING 

ij LI Cl 1 £ 

EOOfl 

61 02 

CMP 

fl 

2 s X 

INDEXED ADDRESSING 

0 ij ij 1 3 

d 0 QC 

27 05 

BEG 


FOUND 

RELATIVE ADDRESSING 

ij 0 ij 1 4 

d 0 OE 

09 

DfcX 



IMPLIED ADDRESSING 

0 ij tj 1 5 

d 0 OF 

56 

DEC 

B 


A C C U M UL A TOR □ ML Y A D D R E S S I N G 

0 ij 0 1 6 

d 0 1 Li 

36 P6 

BNE 


BACK 


i j 0 1 j 1 7 

d 0 1 d 

-J t“- 

i.i.l A I 



WAIT POP INTERRUPT 

0 ij i j 1 9 

d 0 1 -3 

BD 2019 

FOUND -JSR 


SUBRTN 

-JUMP TO SUBROUTINE 

0 ij Od Ci 

d Ci 1 6 

7E 2 0 0 0 

JMP 


START 

EXTENDED ADDRESSING 

00 031 



♦ COMMENT S 

TATEMENT 

NOT E TP IJNCAT ION 0 1 £3456 789 0 1 £3 

00 Odd 

£019 

1 6 

SUBRTN TAB 



COMMENT FIELD TRUNCAT IQNO 1 £ 

i j ij 0 d 3 

d 0 1 H 

BR 2033 

□Rft 

R 

BYTE 

SET MOST SIGNIFICANT BIT 

0 0 Ud'4 

d 0 1 D 

39 

RTS 



RETURN FROM SUBROUTINE 


0 0 036 

8 0 1 E 

0 0 1 4 


RMB 

EO 

d L- R ft T L Fl AREA F 0 R j T A C K 

ij ij 08*7 

8 0 32 

i j i j ij 1 

STACK 

RMB 

1 

START OF STACK 

00088 

2 033 

8 0 

BYTE 

FCB 

330 

FORM CONSTANT BYTE 

00029 

8 0 34 

1 0 


p C B 

* 1 0 ? 34 

'£ INDICATES HEXADECIMAL 


8 035 

04 





0 0 03 ij 

8036 

8 038 

AD DR 

FDB 

DATA 

FORM CONSTANT DOUBLE BYTE 

00 03 1 

80 38 

; 

DATA 

FCC 

7 SET Y FORM CONSTANT DATA STRING ■ ASC 


2 039 

45 






2 0 36 

54 





i j 0 1 j 3 8 




END 



COUNT 

0 0 03 

START 

d D 0 0 

BACK 

£ 008 FOUND 

dO 13 SUBRTN £019 

STACK 

2 032 

BYTE 

d 033 

ft DDR 

£ ij St. DATA 

£038 

TOTAL 

ERROR 

x i m hi 1 1 1 






F-l 


i: 0 0 E ; 0 0 0 05 04 74 D 5 0 £ 0 £ 0£ 0 £ 0 7 0 

SUB £ 0 0 0 Q F. £ 0 5 £ ?E£ 0 3 6 C -i 0 3 ORR 1 0 3 £ 7 0 5 0 •=» 5 q g 6 F 63 E £: I' £ 0 19 7 E £ 0 0 0 1 6 E' h 3 4 
i l 06 2 0 1 B£ 03 3393 = 

I 1 0 £ £ 0 33 3 0 1 0 0 4 £ 0 3 3 5 3 455* 9 
S9 0 3 0 0 0 (IFC 


EXBUG 1.2 PR NT 
BEG R B B R 0 6 0 1 £ 0 0 0 
END RDIlR FFFF £ 03 R 
EXEC V 


£000 3 E £0 32 FE £0 
£010 £6 F 6 3 E BB £0 
£ 0£0 55 55 55 55 55 
£030 55 55 55 ©0 10 
BEG RD DR £000 


36 

L 6 « 

03 

96 

OR 

19 

7 E 

20 

0 0 

16 

55 

55 

55 

55 

55 

04 

30 

-IX 

53 

45 


R 1 0 £ £7 05 09 5 R 
BR £0 33 39 55 55 
55 55 55 55 55 55 
54 55 55 55 55 55 


* cl* 6 F . ■ , ! . * * 

. ■ = . . . . : 39'JU 

U U U U U UU U U IJ UUU UU IJ 
UUU. . . 8SETUUUUU 


F -2 


APPENDIX G 


USING MIKBUG VERSION OF THE M6800 
CO-RESIDENT SOFTWARE WITH THE MEX6800 D1 
EVALUATION KIT 


The MIKBUG version of the M6800 Co Resident 
Software may be used with the MEK6300 D1 Evaluation 
Kit. As discussed in Engineer ing Note 100. The Evaiu* 
ation Kit uses the MIKBUG Firmware stored in the 
MCM683QL7 ROM and interfaces with the selected data 
terminal via a MC6820 Peripheral Interface Adapter at 
addresses 8004 through 8007. Interfacing the Evaluation 
Kit with a RS-232C compatible or TTY (20 m A neutral 
current loop) terminal is depicted in Figure 34 of 
Engineering Note 100. The following changes are required 


to make the Evaluation Kit compatible with the M6800 
Co- Resident Software. 

a. Change the schematic in Figure 3^4 of Engineering 
Note 100 in accordance with Figure 1 of this docu- 
ment. The changes are depicted in dotted lines. Use 
the modified schematic to design and burld your 
terminal interface, 

b. Change the Control H character delete command 
rn Table 2-1 of the M6800 RESIDENT SOFTWARE 
SUPPLEMENT to control H. (In Edition 1 of the 
supplement, add the Control A to Table 2-t.) 
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APPENDIX H 


USE OF OTHER PERIPHERALS WITH THE 
CO-RESIDENT SOFTWARE 


The Co-Resident Assembler/Editor has been designed to operate 
with TTY terminals equipped with automatic reader/punch control, or 
other compatible terminals such as Texas Instruments 733/ASR, Normally 
these console devices are also used for communication with the resident 
system's monitor program. Since other terminal types may offer advantages 
such as lower cost or higher performance, the Co-Resident software was 
designed to easily accommodate other peripherals* All Assembler/Editor 
input /output requests are processed by a common input /out put program 
that resides in memory locations OlOO^g -02FF-^g» 

Each input /output operation, such as punch record, print record, 
etc, is invoked by entering the input /output package through the appro- 
priate jump vector* In the standard version, the input /output routine 
processes the input /output request and performs the input /output operations 
on the console device by calling the elementary input /output routines in 
the resident monitor. As a result, there are three versions of the common 
input /output program: 

EXORciser — Input/Output via EXbug 

Evaluation — Input/Output via MIKBUG 
Module I 

Evaluation — Input /Output via MINIBUG II 
Module II 

In order to substitute the other peripheral devices, the user 
must supply the appropriate input /output drivers and patch the common 
I/O programs so that his drivers are called rather than the standard 
ones. To facilitate such modifications, source listings of the three 
common input/output programs are available through the M68QQ User's 
Group Library* 


LINE PRINTER INTERFACE 

The input /output hardware and common input /output program modifica- 
tions listed in the following paragraphs provide an example of the changes 
required to operate the Co-Resident Assembler/Editor with a line printer 
(Centronics type)* The Disk Operating System includes the necessary commands 
and driver routines for implementing a line printer. The commands and driver 
routines required for paper tape and cassette are provided in the following 
paragraphs. 
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Hardware 


The jumper connections listed in Table HI must be performed if 
the MEX6820 Input/Output Module is used to interface the printer with 
the EXORciser. However, if the MEX68PI Printer Interface Module is 
used, these connections are not required. When using either of these 
modules, refer to the appropriate User’s Guide Supplement. 


Common Input /Output Program 

A. Disk Assembler - ASMB (Version 1.3 Only) 

In order to enable the printer patch included on the 1.3 version 
of the ASMB disk file, the disk file must be amended with the object file 
patch provided in Figure HI, 

B. Disk Assembler - ASMB (Version 1.2 or 1.2A Only) 

Version 1.2 of the disk assembler (ASMB) does not include a printer 
patch. However, the object file patch (ASMPATCH) provided in Figure H2 
may be used to amend this version of the disk file to permit printer opera- 
tion. 


C. Paper Tape and Cassette Assemblers 

Assembler software provided on either paper tape or cassette must 
be amended in the following manner to operate with a printer. 

1. The object file (LPTDVR) provided in Figure H3 must 
be stored in memory at a location contiguous with 
the Co-Resident Assembler and Co-Resident Editor. 

2. The current version of the assembler must be amended 
with the object file (ASMPATCH) listed in Figure H3. 
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TABLE HI MEX6820 Input /Output Module Jumper 
Requirements for Operating With a Line Printer 


PIA 

SIGNAL 

jumper co: 

NNECTIONS* 

PRINTER 
CONNECTOR PIN 
NUMBER 

PIA PIN 
NUMBER 

CONNECTOR 
PIN NUMBER 

CA2 

39 

1 

1 

PAO 

2 

3 

2 

PA1 

3 

5 

3 

PA2 

4 

7 

4 

PA3 

5 

9 

5 

PA4 

6 

11 

6 

PAS 

7 

13 

7 

PA6 

8 

15 

8 

PA7 

9 

17 

9 

CA1 

40 

19 

10 


^Jumper connections to be performed between PIA1 (U13) or PIA2 (U15) on 
MEX6820 and connector P2 or P3 respectively. 


NOTES: 

1. The following pins on connector P2 or P3 (MEX6820) should be 
connected to ground. 

2, 4, 6, 8, 10, 12, 14, 16, 18 and 20 

2. Printer connector pins 19 through 28 should be connected to 
ground. 
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FIGURE HI. ASMB Version 1.3 Object File Printer Patch 
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»fl 5E 0 0 1 


ASM^RTCH 


00001 
00005 
00003 
1 1 00 04 
00005 


MAM ASMPRTCH 
□PT CNS 

♦THIS PROGRAM PATCHES THE M6800 RESIDENT ASSEMBL 
♦ TO REQUEST THE USER TO SELECT IF OUTPUT IS TO B 
♦TO THE PRINTER DEVICE USING THE PROM DRIVER 


fi fi 0 06 


000 0 

PHS S 

EQU 

o 

000 i*i? 


FF3R 

XSTACK 

EQU 

jE PRR 

fi ijfi 03 


FF53 

AECHG 

EQU 

SFF53 

n fj Q 0 ? 


01 IE 

XBRTR 

EQU 

11 IE 

0 0 n l 0 


0 1 1 B 

XC I F 

EQU 

SI IB 

on 01 1 


01 3 3 

XHERD 

EQU 

11 33 

n n n l 3 


0 1 35 

XL I ME 

EQU 

51 36 

0 n n i ? 


H9P5 

LOATA 

EQU 

‘SERB'S 

n n n 1 4 


SR on 

LDATA1 

EQ'J 

SEADD 

n o o i s 


0 1 0 0 

A SMB 

EQU 

$1 00 

n i;i n i 5 

0 030 



ORG 

520 

o n o i ? 

n 03 o 

SE FF8h 


LDS 

pX STACK 

0 n o i 3 

0 0 ■ ' 3 

9 5 0 0 


LDH H 

PR SS 

0 ij o 1 9 

0035 

3 1 09 


CMP R 

»-59 : 

00 030 

0087 

37 19 


BEQ 

ASM *i 

on 031 

0089 

::E 0054 

TGP 

LUX 

«MS5 

00033 

002C 

BD nns 


JSR 

XBRTR 

non? 3 

0 0 3F 

* E 0 0 0 n 


LDX 

»o 

onn?4 

o n 9 ? 

09 

DEL AY 

riEX 


0 0 035 

0033 

36 FP 


BME 

DELAY 

on n ?5 

00 35 

7F FF5 3 


CLR 

RECHD 

00 n ?? 

0 033 

B B n J l E 


JSR 

XC I E 

0 0 0 38 

00 3B 

3 1 59 


CMP H 

it. v v 

>r | 

n 1 1 fi ?9 

no 3D 

37 0? 


BEQ 

PRHTR 

fi 0 0 3 o 

0 0 3F 

31 4E 


cmp a 

a 'IS 

o n o ? i 

0041 

3 6 E 6 


BME 

TUP 

on 0 33 

0 04 3 

?e 01 nn 

ASM 

JMP 

ASMB 

fi o n 3 3 

0045 

CE Eh 05 

PRHTR 

LDX 

«LDATA 

0 n n 34 

0049 

^F 0134 


STX 

XHEAD+1 

n 0 095 

O04C 

CE Eh 00 


LDX 

ttLDATfll 

on n 33 

00 4F 

FF 0137 


STX 

XL I ME + 1 

non 37 

0 053 

3 0 FF 


ERR 

ASM 

0 n Ti 3 3 

0 054 

50 

MSG 

FCC 

'"PRINTER?- 


0055 

53 





0056 

49 





0057 

4E 





0053 

54 





0059 

45 





005R 

53 





005B 

9F 




n o n 3 9 

0 05C 

04 


FCB 

4 

n n o 4 o 




END 



•ES 


FIGURE H2. ASMB Versions 1.2 and 1.2A Object File Printer Patch 
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FIGURE H3 


HR M LPTDVP 

□ PT □ 

□ Pb HERE: U 

♦IN EDO? ASSEMBLER* SET THE FOLLOWING LOCATIONS 
♦ CPDRTR'J = JNP F*DRTA 



♦ i: 

PDRTR 1 i 

= jmp 

PDRTR 1 


EC1 1 

C NT PL 

EQU 


SECl 1 

PIR 

RD DRESS 

Ef:l Cl 

DR TR 

EQU 


3 EC 1 0 

pip, 

RD PP£’S S 

ERB 0 

L I ST 

EQU 


* 



~£ 

PSH fl 






7 F EC 1 1 
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CUT RL 



36 C P 


LDR 

H 

ifJEF 



B7 FC10 


STR 

H 

DRTR 
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LDR 

R 
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Ei? ECU 


STfl 

R 

CUT PL 



32 


PUL 

H 
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H 

DRTR 
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LDR 

R 
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R 
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y A y A 


LDR 

H 
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RTS 
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H 
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H 
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B SR 
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PliRTRl 
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R 
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81 04 
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H 




57 FI 


EEC 
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03 
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2 0 F5 


ERR 


PDRTR 1 
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. Paper Tape and Cassette Line Printer Driver Object File Patch 
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APPENDIX I 


PROM VERSION OF CO-RESIDENT 
ASSEMBLER/ EDITOR 


The Co-Resident Assembler/Editor also is available to operate 
in the ROM environment. The Assembler f s starting address is COOG,. and 
Editor's starting address is 0003-^. The Co-Resident Assembler/Editor 
program uses 7k bytes of ROM and requires a minimum of Ik byte of RAM* 

This Assembler/Editor program resides in memory locations C000^^ through 
DBFFj^ and uses the RAM memory locations OOOO^g through OlFF^g for scratch- 
pad memory. The symbol table starts at memory location 0200^5 and ends 
at the default 1200^, This provides a buffer for 500 symbols. 

To change the size of the symbol table, the user enters into 
memory locations 0100, „ and OlOl^g the end-of-symbol-table address plus 
one. In this case, the user enters the Assembler at C039j^ rather than 
COOOj^ . 


If the object code is to be written into memory (OPT M) , the end- 
of-symbol-table address delimits the address. For example, if the symbol 
table ends at 1200^ (the default address), a program beginning at memory 
location 12O0j^ or may have its output directed into EXORciser memory 
(providing it is available) . 

It should be noted that the edit buffer starts at memory location 
0200 and extends to the end of continuous RAM memory. 
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